home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / gdmake.arc / MAKE.DOC < prev    next >
Encoding:
Text File  |  1986-08-26  |  7.4 KB  |  192 lines
  1. /*
  2.   This a  called 'Make' and is a much simplified version of
  3.   the make utility on UNIX (a trademark or something of AT&T)
  4.   written  using the Lattice C compile
  5.   for the  IBM Personal Computer.  The Lattice package is
  6.   available from Lifeboat Assoc. 1651 Third Avenue
  7.   New York, NY 10128 .
  8.  
  9.   'Make'  takes a  file of  dependencies (a  'makefile') and
  10.   decides  what commands have to be executed to bring the  files
  11.   up to date.  These commands are  either  executed  directly from
  12.   'Make'  or written to the standard output without executing
  13.   them.
  14.  
  15. 'Makefile' format:
  16.   - There  must be  a 'makefile'; you can't  take input from  the
  17.   standard input.
  18.   - The default name of the 'makefile' is  'MAKEFILE'  on the
  19.   default  disk.  Different 'makefiles' can be specified using
  20.   the '-f' option  on the  command  line.  If the '-f' option is
  21.   used, the default 'makefile' is  not processed.
  22.   - Any blank lines in the 'makefile(s)'  are ignored.
  23.   - A line in a 'makefile' that starts with a tab  character is
  24.   a 'howto' line  and consists of  a command name followed  by
  25.   arguments.  The  command  name must be a file name,  e.g.
  26.   'cc'.  When  commands are executed,  the PATH  environment
  27.   variable is used to find the command, in (hopefully) the
  28.   same manner as  DOS does. 'Howto'  lines apply to the most
  29.   recently preceding 'dependency'  line.  It is an  error for
  30.   a 'howto' line  to precede the first 'dependency' line.
  31.   - Any other non-blank line is a  'dependency' line.  'Dependency'
  32.   lines consist of a filename followed by  a (possibly empty) list
  33.   of dependent filenames.
  34.  
  35. Operation:
  36.   Syntax:
  37.     make [filename]  [-f makefilename] [-i] [-n]
  38.   -i means continue even  if an error is encountered while
  39.     executing a command.
  40.   -n means don't  execute  the commands, just write  the ones that
  41.     should be executed to  the standard output.  This is useful
  42.     for creating batch files, for  example.
  43.   -f specifies that the following  argument is the  name of  a makefile
  44.     to be  used instead of  the default (MAKEFILE).
  45.   All arguments may be repeated and relative position of  the
  46.   arguments is not important.  If  multiple definitions of  a file
  47.   are found, only  the first one is significant.
  48.  
  49.   First,  'Make' reads all  of the  makefiles.  It then proceeds through
  50.   all of  the filename arguments,  'making'  each one in turn.  A file
  51.   is remade if it  is out  of date  with respect to  the files it depends
  52.   on or is non-existent.  Dependencies are processed in a  'tree' fashion,
  53.   so that  the lowest-order files  are remade first.
  54.  
  55.   'Make'  cannot execute DOS built-in commands e.g. 'cd' or 'dir'.
  56.   'Make'  uses the  first 20k or so  after the resident portion of DOS.
  57.   all definitions and howto's are stored in dynamically allocated struct's.
  58.  Any executed commands are loaded above 'Make'  in memory.
  59.  
  60.   'Make'  REQUIRES  DOS 2.0  (or higher?).
  61.  
  62.  
  63.   The code is a little kludgy in  places.
  64.  
  65.   No guarantees or warranties of  any kind:  I think it works and
  66.   I use it.
  67.  
  68.   Any suggestions  for improvements gratefully accepted.
  69.  
  70.   I believe that  commercial versions exist.  I also beleive that  they
  71.   would be superior to this.
  72.  
  73. version 2.0 comments:
  74.   This program was converted to Lattice 'C' ver 2.11 on 15 jun 84.
  75.   This allowed the use of the lattice 'fork' command. The command
  76.   will automatically search the path name specified to find the
  77.   desired executable image. This also allows the use of image names
  78.   with out the extension. ie 'lc1' instead of 'lc1.exe'. All of
  79.   the assembler routines have been replaced with lattice dos calls.
  80.  
  81.   The Lattice version uses about 55k bytes less memory than the
  82.   Desmet version. This is nice for the systems with already tight
  83.   memory requirements.
  84. version 3 comments:
  85.   The default makefile name is MAKEFILE not MAKEFILE.DAT.
  86.   There now is a symbol processor to do substitiutions
  87.     in the argument line.
  88.   A symbol definition MUST begin with a $.
  89.   An example follows.
  90.   Fixed a bug-If a dependent file did not exist then make didn't
  91.     work correctly.
  92.   Checks to see if a command results in a non-zero return code.
  93.     If so then aborts unless the -i flag is used.
  94.  
  95.   Any comments on this code should be directed to
  96.   Jeffrey Spidle
  97.   Systems Analyst
  98.   Office of Continuing Education
  99.   Iowa State University
  100.   Ames, IA 50011
  101.   or a message on one of the following BBS.
  102.   Gene Plantz (312)887-4227
  103.   Lynn Long (918)749-0718
  104.   Bob Blackwell (319)363-3314
  105.  
  106.  
  107. */
  108.  
  109.  
  110. /*
  111. Written  by John  M Sellens, April, 1984
  112. Modified for Lattice C ver 2.11 by Jeff Spidle jun 15 84
  113.  
  114. Code is  all original except where indicated otherwise.
  115.  
  116. Until August, 1984:
  117.   jmsellens@watrose.UUCP
  118.  
  119.   107 - 180 Brybeck Cres.
  120.   Kitchener, Ontario
  121.   N2M 5G4
  122.  
  123. After August, 1984:
  124.   c/o 1135 Lansdowne Ave.  SW
  125.   Calgary, Alberta
  126.   T2S 1A4
  127.  
  128. (c) Copyright 1984 John  M Sellens
  129. Permission is granted to use, distribute and/or  modify this code unless
  130. done for direct  commercial profit.  If you find  these routines useful,
  131. modest contributions (monetary or otherwise) will be gratefully  accepted.
  132. Author's name, address and this  notice must be included  in any copies.
  133.  
  134. <TAB> = ASCII 09
  135. An example: To compile this program the following makefile was used
  136. $CFLAGS -ms -i/code/c/lc/
  137. make.exe make.obj
  138. <TAB>link /code/c/lc/s/cs+make,make,make,/code/c/lc/s/lcs -map
  139. make.obj make.c /code/c/lc/stdio.h
  140. <TAB>lc1 make $CFLAGS -i/code/c/lc/s/ -n
  141. <TAB>lc2 make
  142.  
  143.    An explination: make.exe is a dependent file. Is is dependent on
  144.    make.obj. make.obj is dependent on make.c and stdio.h. If the
  145.    following command is issued:MAKE make.exe then make will
  146.    check to see if either make.c or stdio.h has a newer date&time
  147.    than make.obj. if so then the 2 compile instructions are issued.
  148.    then the link instruction will be issued. If only make.obj is
  149.    newer than make.exe then only the link step would be executed.
  150.  
  151. The symbol substitution will end up having the lc1 call look like
  152.   lc1 make -ms -i/code/c/lc/ -i/code/c/lc/s/ -n
  153.  
  154. Hints: Dependencies can be in any order. Make will resolve them
  155.        correctly.
  156.  
  157.        How to lines must begin with a <TAB> not just 7 spaces.
  158.  
  159.        Symbol definition lines must start with a $.
  160.  
  161.        Symbols cannot have other symbols in their definition.
  162.  
  163.        A symbol may have a max of 39 characters.
  164.  
  165.        The equate for a symbol may be up to 80 characters.
  166.  
  167.        You may have an unlimited(within reason) number of
  168.        symbols.
  169.  
  170.        A symbol that is not defined will be copied to the
  171.        output line. ie
  172.        lc2 $TEST
  173.        with $TEST not defined will create the command
  174.        lc2 $TEST
  175.  
  176.        Symbols are case specific. upper and lower case are significant.
  177.  
  178.        The command line must specify what file you wish to
  179.        make. You may have more than one set of file definitions
  180.        in a makefile. If you do  you may run out of memory. I
  181.        haven't run into this yet but I suppose it is possible.
  182.  
  183.        If a command returns an error-code (ERRORLEVEL) not equal
  184.        to zero then MAKE thinks that there was an error. MAKE
  185.        will abort processing unless the -i (ignore errors) flag
  186.        is used.
  187.  
  188. Any suggestions or improvements will be much appreciated. I
  189. am next going to try to put definable symbols for substitution
  190. in a makefile next aka UNIX-MAKE. So we will see what happens.
  191. */
  192.